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1. Project Definitions 
1.1. Product Abstract 


A venilla Pascal program is a text-oriented program that uses s only’ WRITELNs 
- to display its output, and only READLNs to get input. This type of program — 
does not have the ability to access window manager libraries to Girectly | 
interact witn window, menu or the mouse. The vanilla application window 
(sometimes called the vanilla wincow or the application window) provices a 
vanilla Pascal program witn a way to direct its output to a windcw and get 
its input from the keyboard, following the Office System user interface | 
Standards. The vanilla window gives the user of this type of program the . 
capability to spy its output window witn menus and the mouse. witn the. | 
vanilla window such programs can be ported to run in the Office System ssw 
iol modifications in the source code as long as they have run in the 


Por programs that use the Quickdraw (sometines called vanilla QuickOraw 
programs) and run in the Workshop today, the vanilla window also provides a 
way to direct its grapnic output to a window. In additions, for programs 
that use the Hardware unit (HWINT) to get the mouse location (MouseLocation) 
and the mouse events (KeybdcEvent), the vanilla window also provides a way to 
get the mouse coordinates. However, the vanilla window will not support | 
programs that use the Hardware unit to co other hardware control tnat - 
affects the entire system. These programs have to be converted to use tne | 
ToolKit before they can run in the Office System. Other programs that need 


have to be converted to use tne ToolKit as well. There will be only one | 
window for text and graphic output for each vanilla QuickDraw program, even 
if the program uses both WRITELNS and the QuickOraw. 


The vanilla window emulates a terminal display. The text, OUTPLEE that wOULG a 
be scrolled off the top of a typical terminal cisplay is sav oy the , 
_ Vanilla window. This output can be scrolled dack at ay time: The vanil? 3 
- window provices a Stancard Jerminal that performs | terminal turctions: a 
such as positioning the cursor and clearing the screen, etc. It also enables 
third parties to write specific terminal emulators for the vanilla wirdow. 

We are providing a vT100 anc a Soroc terminal cqmpatiole emulators with this 
product. eee | | 


Each vanilla program is associated witn a document unten contains: the output | 
Gisplay of the program. Either all or part of the outout from avaeriiie 
program can be saved in the document. The cocument can ce manipulated cnet 
Same way as other Lisa documents. It can be "Set Aside” or “Seved & Put Le 
Away” and openea later to see the output of the previous run. In acdition, 
eacn vanilla program can deal witn OS files in tne same way as it coes in 
the Workshop. This separation of files ana cocuments will be dealt with in 
the future Desktop Manager. In this proquct release, tne documents wil: se | 

_ manipulated in the Desktop, the OS files wiii 5e handled int ‘the Work snoo 
Shell running in tne Office System. : | | 


avordea 


> © Text Input and Input Panel 


Tunning in the Office System, the programming environment is the same as 
the end user environment. The Lisabug and the NMI key capability snould d¢ 
available to aid debugging and interrupting @ run-away program. ON 


oe 


1.4. Related Documentations 


ToolKit Documents - - Toolkit team, 5/12/83. 
| ‘Lisa User Interface Guidelines, Part I - ~ Alpha Craft, 4/29/83 “ 


2. Programeble Interface Specifications pti | ee es 


The vanilla window unit provides interactions with windows for both vanilla 
programs and users of these programs. The programmable interface, READLN, 
WRITELN and screen control etc., AS described first. The user interface is _ 
Gescribed later. -- == 


Each vanilla window enables users to see through to the program output. This 


Output is either from the program’s WRITELNs or from its QuickDraw calls. These 
two different types of output can be presented in two different. Parelg text — 


panel and graphic panel, each with independent scrolling capability. In 


addition, there is a panel displaying the input buffer whicn contains the 


not-yet-consumed input, the inout panel. The input panel will always be present. ue 


The text panel and grepnic panel can be reconfigured to be separate or oe 
cominedc. The following sections Gescribe these tnree paneis in Gevall. 


‘ig ene 


‘There are two sources of input to a vanilla Pascal program: rur 

vanilla window. One is from the user t yping on tne ke eyboard; . atne otner is 
from the "Paste" command. As it will be cescribed in more detail in tne user 
Interface section, the “Paste” command will put tne. selected ‘ata in the 


program's input buffer. when the program does a READ, tne data in tne input 
buffer, if any, will be consumed to satisfy the READ first. Ano then if tne 
input buffer is empty, the program will walt for: acaivional shade from = 
eitner typing or pasting. — 


_ This inout buffer, containing the not-yet -consutied input, will be atsolayed x 
in tne — pee. 


"aks Text Output and Text Panel. 


The text panel contains the WRUTELN Output of its procram. This panei | 
_ corresponds to the Pascal built-in device OUTPUT and. the logical Gevics — | 
*-CONSOLE’. The panel emulates a terminal display. It. nes 3 saree area: 
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Figure 1. Data flow of WRITELNs and READLNS to 
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; “but t 
_ way to detect that such convention is follo 


‘sueonning rote here 
terminating “long operations, since the van 


‘procedures are not to be overriccen except where ind 


% 


‘line feed). It Goes not interpret any aca key. (Programs. that use 
READ and READLN will nave the backspace key processed by the PASLIB on 
input, i.e., tne backspace key is never. seen by programs. This is cue 
to the Pascal Tun time library, not the Ste ard Terminal.) ‘ 


The standard Lisa applications provice Perio y combination 


, the user can select the “Resume” co 


any access to the application pograms’ opera’ 
suspension can be disapled for programs that nave 
tnis key. See section 2.4 for the procecure cet 


The Standard Terminal has a set of Setup features wit wr : 
can reconfigure the Standard Terminal. This set of fea 

adjusting the maximum number of colums in tne Stancard Term 
either 80 or 132; selecting whether to wraparound or mot a tC 


_ users can invoke Setup features from the “Setup” menu cescrined D2 
Terminal emulators can overT ioe the standard configures ay 


features. eee 
The following procedures describe the standard screen’Contro 
functions that are callable from programs and terminal a ee 

addition to these functions, the state of the St. Termi 


position, etc. Third party software can overrite some. 6 i} 
functions to emulate specific behavior in their termina 2 OT 


we 


Terite (string), Strvrite (string), ctrkeyvrite (char) 


These procedures display the string passed in ‘tne window. The : 
sions May not contain any escape or ,control sequence, axcect a 


om.the PASLIB. It then calls tne’Strwrite or Ctrxeywrite 
ing,on the string. Str#rite:assumes tnat the string: passec. 


‘position. The wraparound feature will ne checkec anc 
gertorned accordingly. Strwrite is a standard function not to ne 
Overridgen Dy otner terminal emuiators. CtrkeyWrite nandles tne- 
standard control keys. ‘Writing a line feed cnaracter. wnen tne | 


ngle control character that belongs to the standard contro! «ey ee 
‘Twrite is the one that will pe calles by the wRITE ana WRITELN 


rol keys, and the string will be disp? ayed starting from 


CORNEA on Te TT | a AC TE a TSS! oF + TSS ¢ ad 


less than 0 the cursor position will be used. If the parameter 
clearall is true, all ve te pasigions will be Cleared. . 
GetLine (y, string, delete), 
The output lines in be screen 2 
(fixed pitcn my). ChangeAttriputes can pe used to. yes | “either 
the character style or the character font. The new att $ wi) 
apply to characters written from tne current cursor position unti 
tne next call to ga eer ore Bata ee is. Heed CO - 
“oro 
= | StopOutputKey (ch), StartOutputKey (ch) : ‘pooles 26: e a 
ae —— The output display can be temporarily stopped. bia geritl By. 
: | entered by a rage and can be restarted again 0} TY peed antrol 


key Biaity by the user. me Standard dee 


pe The display control in the Seats te 
Ss fiat is calls to these sae rout’ nes stoi 


The VT100 ANSI. ‘terminal, is popular in the inaustry. 
VT100: ANSI compa 
venilla fascal. programs to tne Office System. Tis will 215c 
dengnstrate, @n example for oxner terminal emulators. 


iy awe? 


¥e vill provis 


This emulator will exist an a separate unit. It “interprets all che. 
VTi00. and VTS2 escape sequences, except the ‘ones related to ene ‘most 


tiple terminal emulator to nelo pore "a large nummer cf 


¢ 
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insige the arecnic panel. If the mouse ig not ‘inside the ere a (-1, -1) 
point is returned. This procedure emulates the MeuseLocation in tne HWINT 
unit. Tne MouseDown function returns true when the mouse button is pressed, 
the corresponding mouse coordinate. is also returned. Application programs 
that need to track the mouse can call this function repeatedly until the 
mouse button is pressed. Programs that are calling touseLocaticn and 
KeydcEvent now will have to Modified. £0 Call MouseCoardinate and 


MouseDown respectively. Since the mouse. ot used for ‘making selection in 
tne graphic panel (the menu command -se “All n " must be used to make 
selection), there there will be no ¢ 1 | 

‘that need to use | cst) proviees 


| the office System. For programs to run ne vanilla window, they can not 
access the low level event queue to get the mouse 
events. They can mot cnange the syste 
hourglass busy cursor since it is use 
is busy. The kind of hardware access. 
affect the bs system or otner pF 
microsecond ang miliisecond timer, € ; 


Jne graphic support will be in a unit 


ga ee a that the system 
vat. which does ‘rot 


pport (the 

E botn of 

ata flow from 
a cai to its window. =: | 


2.4. Configure the Panels 


The aiatae HavePanel can be either to nave botn text: - apnic 
panel or to nave one panel for both text and grapn itout. P e. 
fave text panel and grapnic panel, can specify to have tne text panel 
above;below, tothe right of, or to the left of the’ graphic panel vii 


pareneter ro0rientation. Screen oriented programs can specify tnat no puffer 


Is desired by setting HaveBuffer to false. Programs tnat neec to get a 
e-Period” key can specify PassApplePeriod’ to be true. Anc tne 
oan ore gibi! 


5 SHoula mace this call before generating any output: If this call is 


not made, , the venilla window will use its ceraults. ‘The default *9r ia ees = 


| and no “apple-Period” ‘passed tO. programs. Sor graonic “programs, tne cefauit. ie 
is to nave one panel only for soth text and grapnic bodes ne Suffer ares, eo 
and no “Appl Period” passec to. ‘programs . | | 


— 4 snows: a few wincow tay. out of different pare or? tentations. | 
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_ | ae 
Figure 3. Data flow of WRITELNs, READLNs and QuickOraw output to a vanilia window from 
ap that uses the Vanilla Window/Standard Terminal Unit anc tne QuicrDraw 


wincow Unit. oy Se os 


voit | 


with the vanilla programs. 
t difference between ‘the vanilla programs anc Lisa 


There is @n | 
applications such its we to provide some extra commands to allow users to 
fully control p execution and to make the vanilla wincow user interface be 


more consistant with other 
style program which always 
from the 


, A vanilla program, unlike a Lisa 
$ on getting events and processing events, runs" 
} s the end, ithas <‘ 


re a 


window to close before the user has a chance to look at the p ‘s output. 
At this stage, we need to make the'venilla program: al ve but. idle, and waiting 
bay the “Set Asics” or the Away" commands ie 


program will still be at tnis = Desktop 
user can examine the output of the 
this process. ma 


If the user wants to re-run the ig 


eregren 


2 an just srouse 


At any came" erie” the program has not reacne ate statement ‘ the uset on 


select the “Set. Asioe". OF the cave & Bue Many 


execution until. a “read: oF. ‘the | “end” “statement. men tne socument is | reovenea, 
there may be more output than when it was set asice. If “Save & Put Away” is _ 
selected, the progrem will pe terminated. wnen the document is reopened, tne 


7 of the previous Tun will be displayec, ana the Penge am will start Aro 


ee is. selected. 


the beginning if the “Res 


fe 


The “Flush Input" command is used to delete all the input in tne input 
. buffer before the program reads the input. — ok 


The “Select All Text” will select the entire text panel. ‘7S 


_ The “Select All Graph” will select the entire grapnic panel. This command 
will appear shen the ‘Graphic panel exists. 


The “Setup” ‘command allows the ‘Standard Terminal or specific terminal 


emulator to be is menu is selected, a dialog box . 
will show up with some check box for a user ‘to select the appropriate 


. features. The Standard Terminal will pr 


features: at 


. a 
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Cnaracters per-=tine 2 


3.1.4. Execution - Restart, 


ante 


ror-eencing Gane ical ‘gevice, snould also be olracted ¢ to tne bya Qu wnen 
a vanilla program USEs tne vanilla window unit. If a. program 3 NOT VSSAG. 
the vanilla window unit, all its WRITELNs are sent to the Alternat= Screen. 
In any case, programs can open ‘-ALTCONSOLE’ (RESET of tnis name } O° 320 
ing WRITELNS to the Alternate Screen even if tne programs are eSina 
tne vanilla wincow unit. Programs can also cpen ‘-RSZ32A-x' (sr aS2528 
send WRITELNS to an external terminal. The KEYPRESS funccion meecs tc nave 
additional support to allow one of these console cestinations tc S 


The Pascal REWRITE procedure requires creation of a temporary file. with the 
vanilla window, there may be more.than one orogram running at the same time. 
The current make and kill mechanism for temporary files causes the second 
REWRITE call to fail if tne first REWRITE is in between the make and kill 
Calls.-We need an indivisible OS call to make a mcaeand file so 
simultaneous REWRITES will not fail. 


6.3. ToolKit end Stable end Extensible recrenisa need to be ready. 


‘The vanilla window will use the Toolkit for its. implementation. The Toolkit — 

_ has to be Teady before we can release this product. The vanilla window will | 
: depend on the ToolKit and the lower-level libraries. we 
xtensiple Mechanism in place when we release this 

yy users. *. need to be able to Telease enhanced | 


E ‘indo, a vanilla program running in the office systen will 
jer time to come up tan int the Workshop today, since the 


fibraries routines. There will be much’ ‘more ‘programs Tunning in the Office 
System than today. The new OS has to be ss before we can rel ease mes 
- product. 7 eo | | 


6.5. 
The first intetrid: elease. - Sesteaber, 83 = Done 
with: functional ireerfacké in place but not the user interface (menus), 
witn text panel only 
with VT100 emulator and Sorec Emulator 
with this release,” we can start porting the vorksrop tools. 


The second internal. release” bg . November, a3 Yat 
witn user interface in. place, text panel only | 


The tnira ‘{nteirad release - -Decenver, 8 
with grapnic arel. | 


The Alona Release | - : January, CS 
: The Beta Release - Fetruary, 84 64 
Procuct Release - March, va eo 


